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SYSTEM AND METHOD FOR MANAGING MESSAGES ON A QUEUE 



CROSS-REFERENCE TO RELATED APPLICATIONS 

[0001] None. 

STATEMENT REGARDING FEDERALLY SPONSORED 
RESEARCH OR DEVELOPMENT 

[0002] Not applicable. 

REFERENCE TO A MICROFICHE APPENDIX 
[0003] Not applicable. 

FIELD OF THE INVENTION 
[0004] The present invention is directed to computer software for controlling output and 
more particularly, but not by way of limitation, to a system and method for viewing a 
message from a queue. 

BACKGROUND OF THE INVENTION 
[0005] Computer programs or applications may comprise several intercommunicating 
software modules, components, or processes executing on multiple computer systems. 
The modules may communicate with each other by sending messages to each other. 
Some applications employ the Java Messaging Service (JMS) for intercommunication 
among modules or processes. 

[0006] JMS provides support for message-based communication between separate 
Java processes. This message-based communication is asynchronous. More specifically, 
a message addressed to a recipient or group is sent, and the recipient receives and acts 
on the message at some later time. Clients of the JMS send and receive messages 
through a provider that is responsible for delivering messages. In point-to-point JMS. a 
message is created by one client and addressed to a single remote recipient. The provider 
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is handed the message and delivers it to the one recipient targeted by the message. This 
model revolves around message queues. A message sender queues outgoing messages 
for delivery, and a message recipient queues incoming messages for handling. In some 
cases a J MS server supports the queue, and the message recipient must read from the 
JMS server's queue. In some circumstances, in a test environment for example, 
messages may persist and may not be removed from the queue, the queue may become 
cluttered, and message operations may become inefficient. 

SUMMARY OF THE INVENTION 
[0007] The present embodiment provides a system for managing messages on a 
queue. The system comprises a first module operable to read a plurality of messages from 
the queue and a second module operable to display the plurality of messages from the 
queue. 

[0008] In one embodiment a method of viewing messaging service messages is 
provided. The method comprises selecting a host computer, selecting a queue supported 
by the messaging service, reading a message from the queue, and displaying a content of 
the message. 

[0009] In one embodiment a method of testing an application which generates 
messages is provided. The method comprises running the test application, generating a 
message by the test application, posting the message to a queue, selecting the queue, and 
reading the message on the queue to verify whether the test application is operating 
properly. 

[0010] These and other features and advantages will be more clearly understood from 
the following detailed description taken in conjunction with the accompanying drawings and 
claims. 
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BRIEF DESCRIPTION OF THE DRAWINGS 
[0011] For a more complete understanding of the presentation and the advantages 
thereof, reference is now made to the following brief description, taken in connection with 
the accompanying drawings and detailed description, wherein like reference numerals 
represent like parts. 

[0012] Figure 1 is a block diagram of a message manager system according to one 
embodiment. 

[0013] Figure 2 is a block diagram of a message manager system according to another 
embodiment. 

[0014] Figure 3 is an exemplary message manager graphical user interface, in yet 
another embodiment. 

[0015] Figure 4 is an exemplary message searching graphical user interface. 

[0016] Figure 5 illustrates an exemplary general purpose computer system suitable for 

implementing the several embodiments of the message manager system. 

DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENTS 
[0017] It should be understood at the outset that although an exemplary implementation 
of one embodiment of the present system is Illustrated below, the present system may be 
implemented using any number of techniques, whether cunrently known or in existence. 
The present disclosure should in no way be limited to the exemplary implementations, 
drawings, and techniques illustrated below, including the exemplary design and 
implementation illustrated and described herein. 

[0018] Computer programs or applications may be tested when they are being 
developed. It may be prudent to test the individual software modules, components, or 
processes which comprise the application independently before attempting to execute 
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them all together. When a test application cx)mponent outputs messages, it may be useful 
to verify that the messages output by the component are correctly structured, that the 
messages contain connect infonmation in the fields of the message structure, and that the 
messages are sent to the right destination, for example. It may also be useful to read 
these messages without removing them from the system or consuming the messages. 
Reading the messages without diverting them from their normal receiver minimizes the 
impact on the system under test. The present system is directed to a useful tool and/or 
utility that is readily adapted to read and manage these messages in the queue on the 
message sen/er. This is advantageous, for example, during testing since the software 
which receives the messages may not be mature enough to be employed as a message 
reader during initial testing of the message sending component. 

[0019] Turning to Figure 1 a message manager system 10, constructed according to 
one embodiment, is depicted. The message manager system 10 comprises a reader 
module 12 and a viewer module 14. The reader module 12 is operative to read messages 
from a message queue 16. The message queue 16, in some embodiments, is supported 
by a messaging service 18. The viewer module 14 is in communication with the reader 
module 12 and is operable to access the messages read by the reader module 12 and to 
display the contents of the messages. The message manager system 10 is a software 
program, application, or component which may execute on a general purpose computer 
system or may execute in a distributed manner across multiple general purpose computer 
systems. General purpose computer systems are discussed in more detail hereinafter. 
[00201 The reader module 12 communicates with the message queue 16 through 
standard protocols or procedures. The reader module 12 may communicate with the 
message queue 16 employing socket communication mechanisms, for example. The 
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reader module 12 may communicate with the message queue 16 employing Java 
Message Service (JMS) procedures. The reader module 12 may employ other standard 
message communication protocols or procedures for communicating with different queues. 
Communication between the reader module 12 and the message queue 16 may be indirect 
and may be mediated by the messaging service 18 which encapsulates the message 
queue 16. 

[0021] The messages on the message queue 16 may be sent indirectly to the message 
queue 16, mediated by the messaging service 18, by other software components, 
applications, or modules, not shown. The messages are directed to some other software 
components, modules, or applications, also not shown. These other software components, 
modules, or applications may indirectly read or retrieve these messages from the message 
queue 16, mediated by the messaging service 18. The messaging service 18 is a software 
application, module, or component which executes on a general purpose computer system 
or may execute in a distributed manner across multiple general purpose computer 
systems. The messaging service 18 may be provided by a third party software vendor. 
The messaging service 18 may execute on the same general purpose computer system 
that the message manager system 10 executes on, or it may execute on a different 
system. 

[0022] The structure of the messages may vary considerably among the several 
embodiments contemplated. The structure of the messages is determined by the sending 
and the receiving applications. The messages may contain several distinct fields or 
attributes which organize the information earned in the messages. For example, a JMS 
message may include a JMStype field that identifies the type of the message, a 
JMSExpiration field that indicates in milliseconds when the message will expire, a 
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JMSPriority field with a value from 0 to 9 that indicates the urgency of the message, a 
JMSDeliveryMode field that indicates whether or not the messaging service 18 is expected 
to persist the message across a server crash, a JMSCorrelationID field that identifies 
another message with which this message is related, a JMSReplyTo field which indicates 
where the receiver may send a reply, and a properties field which contains an indefinite 
number of name/value pairs. These are examples of a message structure, and other 
message structures are contemplated which may differ from this exemplary message 
stnjcture and may contain more or fewer fields. Other message stmctures may employ 
different names for the fields. 

[0023] The viewer module 14 communicates with the reader module 12 to access the 
messages that the reader module 12 has read. This access may take the form of the 
viewer module 14 sending a request to the reader module 12 to read and return messages 
or it may be initiated by the reader module 12 reading and sending messages to the viewer 
module 14. The viewer module 14 is operable to display the content of the messages read 
from the message queue 16. 

[0024] Tuming to Figure 2, another embodiment of the message manager system 10 is 
depicted. In this embodiment a controller module 20 is in communication with the reader 
component 12 and the viewer component 14. The controller module 20 is operable to 
exercise control over the reader component 12 and the viewer component 14. 
[0025] The controller module 20 may select different operating modes of the reader 
module 12. For example, the controller module 20 may select the reader module 14 to 
read messages destructively from the message queue 16, such as to read from the 
message queue 16 in a manner that removes the message when the message has been 
read by the reader module 12, such that the message is no longer stored on the message 
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queue 16. This capability to remove messages from the message queue 16 by reading the 
messages may be useful when messages acx^umulate on the message queue 16 and 
impede system operations. In other circumstances, however, it may be important that the 
reader module 14 be selected to read messages non-destmctively. This may be 
necessary, for example, when testing a deployed system where messages need to flow out 
to their normal receivers rather than be diverted to the message manager system 10. The 
controller module 20 may select different operating modes of the viewer module 14. For 
example, the controller module 20 may direct the viewer to display an expanded view of a 
message properties field. 

[0026] The controller module 20 is further operable to sequence user actions to control 
the behavior of the viewer module 14. For example, the controller module 20 is adapted to 
receive user inputs identifying a messaging server host computer where message queue 
16 is located. The controller module 20 provides this information to the reader module 12 
to establish communication with the message queue 16. 

[0027] In some embodiments the responsibilities of the controller module 20 are 
assumed by the reader module 12 and the viewer module 14, thus obviating a separate 
controller module 20. 

[0028] Turning now to Figure 3, an exemplary message manager window 50 is 
depicted. The message manager window 50 is a graphical user interface (GUI). In some 
embodiments the message manager window 50 may have different control buttons and 
different functions than those depicted in Figure 3 and described below. 
[0029] The message manager window title 52 identifies the window as the message 
manager window. A message server ID input box 54 provides for inputting the location or 
identity of the message server where messages on the queue 16 are to be managed. A 

12611.01/4000.13300 n 



queue ID input box 56 provides for inputting the identity of the message queue 16 whose 
messages are to be managed. A destructive read Yes select button 58 and a destructive 
read No select button 60 select whether the reads perfomned by the reader module 12 
delete the message from the queue ("yes" is selected) or leave the message intact on the 
queue ("no" is selected). The selections are mutually exclusive. 

[0030] A start button 62 starts the actions of the message manager 10 to display and 
manage messages. A stop button 64 stops the actions of the message manager 10 to 
display and manage messages. A window dismiss button 65 dismisses the message 
manager window 50 and causes the message manager 10 to terminate. 
[0031] A save button 66 causes the text fill-in fields 54 and 56 and the destructive read 
select button selections to be saved in memory. A load button 68 causes the last saved 
input boxes 54 and 56 and the destructive read select button selections to be read from 
memory and loaded into the input boxes 54 and 56 and the destructive read select button 
selections to be set. These settings could be saved to a named file, selected from a list of 
named files, and reloaded. 

[0032] In one embodiment activating the save button 66 causes a first GUI dialog box to 
pop-up. The first GUI dialog box provides for inputting the name under which to save the 
infonnation in the input boxes 54 and 56 and the destructive read select button selections. 
The first GUI dialog box also provides a save button. When the save button is clicked 
these settings are saved. In this embodiment, activating the load button 68 causes a 
second GUI dialog box to pop-up. The second GUI dialog box provides a list of names 
under which input has been saved. Clicking on one of the names causes the stored 
settings to load into the input boxes 54 and 56 and the destructive read select button 
selections. 

12611.01/4000.13300 Q 



[0033] A message view frame 70 displays the messages read by the reader module 12. 
The messages are displayed in this embodiment in a hierarchical tree structure. Messages 
may be displayed as a summary name and date and time stamp. Under the summary 
name, the attribute names are displayed. Attributes may include message type, message 
expiration, message priority, message mode, message conrelation identify, message reply 
to, and message properties. Under each attribute name, the attribute value may be 
displayed. For example, under a message type attribute a value of MapMessage may be 
displayed. Under the properties attribute, individual name/value pairs are displayed. A 
name/value pair means the attribute name along with a specific value, for example, 
"serviceOrderiD: 4532111" where the property name is serviceOrderiD and the property 
value is 45321 1 1 . The capability of viewing the values of attributes and properties is useful 
in testing to discriminate messages sent from a software application under test from 
messages sent by other applications also posting messages through the messaging 
service 18. The capability of viewing the values of attributes and properties is useful in 
testing to discriminate among different messages sent by the software application under 
test. 

[0034] Double clicking on a properties name/value pair causes a pop-up window to 
display the full text of the selected properties name/value pair. This feature is useful if the 
name/value pair is too long to display in a single line of text in the message view frame 70. 
This feature is also valuable because the tester can see if the entire message is correct or 
not. 

[0035] A find button 72 operably displays a message search pop-up window. The 
message find pop-up window will be discussed in more detail hereinafter. 



12611.01/4000.13300 



9 



[0036] Turning now to Figure 4 an exemplary message find window 100 is depicted. 
The message find window 100 is a GUI that allows searching of the messages in the 
queue 16. In some embodiments the message find window 100 may have additional or 
different control buttons and functionality than those depicted in Figure 4. 
[0037] A title 102 identifies the window as the message find window. A search by input 
box 104 provides for inputting the search mode. Clicking on the down arrowhead at the 
right end of the box causes a list of valid search modes to be listed. Search modes may 
include properties, message type, message expiration, message priority, message mode, 
message conrelation identity, message reply to, etc. These modes are employed to search 
for messages that share a common property or attribute value. For example, a tester may 
select a message priority mode to search for all high priority messages. A find input box 
106 provides for inputting the search pattern which may include wildcard characters. A 
case sensitive check-box 108 provides for selecting a case sensitive search. A whole word 
check-box 110 provides for selecting a whole word search. A find next button 112 provides 
for starting the search. A close button 114 provides for closing the message find window 
100. An exit button 116 also provides for closing the message find window 100. 
[0038] The search pattem input in the find input box 106 may specify multiple keywords 
to search for. A match exists if any of multiple keywords specified is found in a message. 
A search pattem may involve special characters, known as wildcard characters, which may 
designate that any character may be substituted in the place of a single character wildcard 
character or which may designate that any number of any characters may be substituted in 
the place of a multicharacter wildcard character. For example, if the single character 
wildcard character is the percent sign character, the text pattem '%ox' would be matched 
by the words 'box' and 'fox.* Again, for example, if the multicharacter wildcard character is 
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the ampersand character, the text pattern *fire&* would be matched by the words 'fire', 
'fireplace', 'firewood', 'fireman', 'firemen', etc. 

[0039] A search pattem may employ anchor characters to anchor the search pattern to 
either the start or the end of the text line being analyzed for a match. As an example, if the 
dollar sign ('$') is used to anchor to the beginning of the text line, the search pattern '$run 
would be matched by the text line "Run spot, mnl" but would not be matched by the text 
line "Walk don't run." 

[0040] If the whole word search mode is selected the search pattem must be matched 
by a text line wherein the search pattem occurs set off from sunrounding text as a separate 
word. For example, the search pattern 'fire' does not find a whole word search mode 
match in the word 'fireplace.' If a case sensitive search mode is selected the search 
pattern must match not only character by character but also match upper case to upper 
case and lower case to lowercase. For example, the text pattem 'Java' does not find a 
case sensitive match in the words 'java' or 'JAVA.' If the case sensitive search mode is not 
selected, the text pattem 'Java' is matched by both 'java' and 'JAVA.' 
[0041] The message find capability allows for searching of message titles, elements of 
message contents, entire message content among messages on the queue 16. This 
capability provides the tester powerful tools for selecting from all messages on the queue 
16. The search capability provides several ways to reduce the volume of messages that 
the tester needs to analyze to find relevant messages. 

[0042] In one embodiment, the display and control components of the message 
manager window 50 and message find window 100 may be implemented with reusable 
GUI component technology. The Java Swing package, for example, includes components 
JTextField, JRadioButton, JButton, JTree, JCheckBox, and JComboBox which may be 
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employed to implement the aspects of the message manager window 50 and message 
search window 100. Other programming techniques and GUI technologies also may be 
employed. 

[0043] The message manager window 50 and message find window 100 GUIs 
described are exemplary. Different embodiments of the present disclosure may have GUIs 
that vary in several aspects from the message manager window 50 and the message find 
window 100 GUIs depicted in Figure 3 and Figure 4 and described above. 
[0044] In some embodiments, the control and display functions of the message 
manager window 50 may be provided through a command line Interface. For example, the 
message content displayed in the message view frame 70 may be displayed in a textual 
outline form where the initial control inputs are provided as arguments to a command. In 
other embodiments the command to start the message manager 10 may activate a query- 
response sequence to step a user through the process of supplying inputs to initialize the 
message manager 10. In sonie embodiments there may be both GUI supported controls 
and command line or function key supported controls. 

[0045] The message manager system 10 described above may be implemented on any 
general-purpose computer with sufficient processing power, memory resources, and 
network throughput capability to handle the necessary workload placed upon it. Figure 5 
illustrates a typical, general-purpose computer system suitable for implementing one or 
more embodiments disclosed herein. The computer system 380 includes a processor 382, 
which may be refen^ed to as a central processor unit or CPU, that is in communication with 
memory devices including secondary storage 384, read only memory (ROM) 386, random 
access memory (RAM) 388, input/output (I/O) 390 devices, and network connectivity 
devices 392. The processor may be implemented as one or more CPU chips. 
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[0046] The secondary storage 384 is typically comprised of one or more disk drives or 
tape drives and is used for non-volatile storage of data and as an over-flow data storage 
device If RAM 388 is not large enough to hold all working data. Secondary storage 384 
may be used to store programs which are loaded into RAM 388 when such programs are 
selected for execution. The ROM 386 is used to store instructions and perhaps data which 
are read during program execution. ROM 386 is a non-volatile memory device which 
typically has a small memory capacity relative to the larger memory capacity of secondary 
storage. The RAM 388 is used to store volatile data and perhaps to store instructions. 
Access to both ROM 386 and RAM 388 is typically faster than to secondary storage 384. 
[0047] I/O 390 devices may include printers, video monitors, keyboards, mice, track 
balls, voice recognizers, card readers, paper tape readers, or other well-known input 
devices. The network connectivity devices 392 may take the fomri of modems, modem 
banks, ethemet cards, token ring cards, fiber distributed data interface (FDDI) cards, and 
other well-known network devices. These network connectivity 392 devices may enable 
the processor 382 to communicate with an Intemet or one or more intranets. With such a 
network connection, it is contemplated that the processor 382 might receive infomiation 
from the network, or might output information to the network in the course of perfomiing the 
above-described method steps. Such information, which is often represented as a 
sequence of instructions to be executed using processor 382, may be received from and 
outputted to the network, for example, in the fomi of a computer data signal embodied in a 
earner wave. 

[0048] The processor 382 executes instructions, codes, computer programs, scripts 
which it accesses from hard disk, floppy disk, optical disk (these various disk based 
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systems may all be cx)nsidered secondary storage 384). ROM 386, RAM 388, or the 
network connectivity devices 392. 

[0049] The embodiments of the message manager system 10 provide a useful, and 
reusable testing tool. Whereas in some environments the tester may only be able to 
detemfiine that messages have been received by the queue 16 of the messaging service 
18 but not what application sent the messages or what the content of the messages is, the 
message manager system 10 can display the content of the messages and thereby identify 
what application sent the messages and when the messages were sent. 
[0050] The message manager system 10 allows the tester to view messages without 
consuming the messages or removing them from the queue 16. This means the message 
manager system 10 does not alter the software system it is monitoring, it is nonintrusive. 
This may be a necessary property when probing or analyzing messages on a queue 16 in 
a deployed functioning system where the testing activity cannot be pennitted to interrupt 
business operations by taking the system off line for testing. 

[0051] Additionally, the message find capability provides a powerful tool for the tester to 
reduce the volume of messages they need to comb through to find the messages they 
need to analyze. The message find capability provides several different searching 
approaches so that the tester can use the tool in the way which best suits their needs 
rather than having to accommodate themselves to a single search mechanism. 
[0052] While several embodiments have been provided in the present disclosure, it 
should be understood that the disclosed systems and methods may be embodied in many 
other specific fomis without departing from the spirit or scope of the present disclosure. 
The present examples are to be considered as illustrative and not restrictive, and the 
intention is not to be limited to the details given herein, but may be modified within the 
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scope of the appended claims along with their full scope of equivalents. For example, the 
various elements or components may be combined or integrated in another system or 
certain features may be omitted, or not implemented. 

[0053J Also, techniques, systems, subsystems and methods described and illustrated in 
the various embodiments as discreet or separate may be combined or integrated with other 
systems, modules, techniques, or methods without departing from the scope of the present 
disclosure. Other items shown as directly coupled or communicating with each other may 
be coupled through some interface or device, such that the items may no longer be 
considered directly coupled to each but may still be indirectly coupled and in 
communication with one another. Other examples of changes, substitutions, and 
alterations are ascertainable by one skilled in the art and could be made without departing 
from the spirit and scope disclosed herein. 
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